package cn.lngaosu.lwyd.module.integration.service.weixinuseranalysis;

import java.util.*;
import javax.validation.*;
import cn.lngaosu.lwyd.module.integration.controller.admin.weixinuseranalysis.vo.*;
import cn.lngaosu.lwyd.module.integration.dal.dataobject.weixinuseranalysis.WeixinUserAnalysisDO;
import cn.lngaosu.lwyd.module.integration.dal.dataobject.weixinuseranalysis.WeixinUserSummaryDO;
import cn.lngaosu.lwyd.framework.common.pojo.PageResult;
import cn.lngaosu.lwyd.framework.common.pojo.PageParam;

/**
 * 微信用户分析表(增减合计、总用户量) Service 接口
 *
 * @author 张恒
 */
public interface WeixinUserAnalysisService {

    /**
     * 创建微信用户分析表(增减合计、总用户量)
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createWeixinUserAnalysis(@Valid WeixinUserAnalysisSaveReqVO createReqVO);

    /**
     * 更新微信用户分析表(增减合计、总用户量)
     *
     * @param updateReqVO 更新信息
     */
    void updateWeixinUserAnalysis(@Valid WeixinUserAnalysisSaveReqVO updateReqVO);

    /**
     * 删除微信用户分析表(增减合计、总用户量)
     *
     * @param id 编号
     */
    void deleteWeixinUserAnalysis(Long id);

    /**
    * 批量删除微信用户分析表(增减合计、总用户量)
    *
    * @param ids 编号
    */
    void deleteWeixinUserAnalysisListByIds(List<Long> ids);

    /**
     * 获得微信用户分析表(增减合计、总用户量)
     *
     * @param id 编号
     * @return 微信用户分析表(增减合计、总用户量)
     */
    WeixinUserAnalysisDO getWeixinUserAnalysis(Long id);

    /**
     * 获得微信用户分析表(增减合计、总用户量)分页
     *
     * @param pageReqVO 分页查询
     * @return 微信用户分析表(增减合计、总用户量)分页
     */
    PageResult<WeixinUserAnalysisDO> getWeixinUserAnalysisPage(WeixinUserAnalysisPageReqVO pageReqVO);

    // ==================== 子表（微信用户增减数据） ====================

    /**
     * 获得微信用户增减数据列表
     *
     * @param analysisId 分析表数据主键
     * @return 微信用户增减数据列表
     */
    List<WeixinUserSummaryDO> getWeixinUserSummaryListByAnalysisId(Long analysisId);

    /**
     * <p>作者: 张恒
     * <p>描述: 同步微信用户增减及总计数据
     * <p>日期: 2025/6/19 16:45
     */
    void syncWeixinUserAnalysis();

}